Problem Being Solved

A developer needs to link to a section on a page or to navigate to another page.

When to Use

Use a link if you're navigating somewhere (a different point on a page or a new page).

When Not to Use

Do not use a link if a button should be used instead (or vice versa) — a link navigates you to a place, a button does something (submits a form, opens a modal, etc...).

Formatting

• Links always have an underline.
• NEVER use target="_blank" to open a new page with anchor links due to accessiblity issues.

Problem Being Solved

We need a way to indicate to users that a link has a client-side state. This includes loading / expired / login required.

When to Use

Stateful links should be used when the associated href is populated after page load, the href target has an expiration date, and/or when the target requires login and it is desireable to show the link details to users.

When Not to Use

When a links href target is known at page generation, the target does not expire, and/or the link does not depend on user login status.